IPTOOL readme.txt

Description:
============

IPTOOL.EXE is a utility for creating property stream files and HTML tags for
embedding OLE objects in web documents.


BACKGROUND:
===========

First, a little background.  Internet Explorer supports two different types of
OLE embeddings.  The first type requires no initialization data when created.
This type of embedding can be created by simply specifying the CLSID of the
object in an INSERT tag.  Optionally, it is usually a good idea to also provide
a WIDTH and HEIGHT:

<INSERT CLSID="{C932BA85-4374-101B-A56C-00AA003668DC}" WIDTH=300 HEIGHT=200>

The second (and more interesting) type of control requires a set of data for
initialization purposes.  Internet Explorer defines a format for a stream of
data which is used to initialize a control:

|16 byte CLSID|     rest of persistent data   |

This is a stream where the first 16 bytes contains the CLSID of the object, 
and the rest of the stream contains initialization data for the control.  The
initialization data is created by calling the control's IPersistStream::Save
method.  This type of embedding can be specified in HTML as (for example):

<INSERT WIDTH=300 HEIGHT=200 PERSISTSTREAMSRC="D:\ipsfiles\foo.ips"

Note:  It is not necessary to specify the CLSID separately when using the
PERSISTSTREAMSRC attribute of the INSERT tag.


USAGE:
======

To use iptool, launch the application and choose "Edit | Insert New Control".
This will bring up the standard OLE insert object dialog.  Make sure to select
the radio button labeled "Insert control" to get a listing of the OLE controls
available on your system.  Choose one of the controls.

The control should appear in the iptool window.  Resize the control to the
desired dimensions and select "Properties | Properties" to bring up the 
property pages for the control.  Set any properties you desire and press OK
on the property page dialog.

At this point, you are ready to generate the property stream file.  Choose
"Properties | Save Content".  This will bring up another dialog.  You will
notice that many of the controls are disabled for now.  However, you can
assign an ID to the control and specify whether the CLSID should be included
in the HTML.  If you also want to generate a property stream file, make sure
to select the radio button labeled "Property file"  Press OK on the dialog.

If you have chosen to create a property file, a file "Save As" dialog will
appear.  Save the file in the location and name of your choosing.  

The Appropriate HTML has been automatically generated and placed on the
clipboard for you.  Simply open the source for a web page and insert the
contents of the clipboard.


CAVEATS to IPTOOL.EXE
======================


1) In the Insert Object dialog box, the "Create New" and "Create from File"
radio buttons are not supported.

	-Users should choose the "Insert Control Dialog" radio button only.


2) In the Insert Object dialog box, when choosing the "Insert Control Dialog"
radio button, the "Add Control" command button does not work.

	-Users should choose only from list presented in "Object Type" window.


4) Your OCX will not show up in the "Object Type" window unless it is 
marked as insertable.

	-Run regsvr32 <ocx name>
	-Run regedit.exe
	-Look in MyComputer\HKEY_CLASSES_ROOT\<ocx name>
	-Add the Key "Insertable" as a subkey under <ocx name> 
	-Note: "CLSID" should already be present as subkey to <ocx name>.

	-Within "Insertable" Key, leave Name to (Default) and Data to "".

	-Note: Most VB4.0 OCXs are registered without the "Insertable" key
	 statement.